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Course Objectives 


» Provide guidance for you to design the 
next generation of platform APIs 


» After successfully completing this 
course, you will: 


» Understand the breadth of issues ‚NET library 
designers face 
« Be equipped to build great .NET libraries 


» Have access to resources to help you deal with 
ongoing issues 


E 
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Introductions 


About the Instructor 


Student Introductions (via e-mail list—aesianah) 
» Name 

» Title/function 

» Job responsibility 

» Product group and experience 

» Expectations for the course 


Course Materials 


terrae Technical Erica 


Facilities 


+ Class Hours 
» 9:00 A.M. start 
+ 11:45-12:45 lunch (not provided) 
+ 5:15-5:45 P.M. finish 

» Meals 


» Buildings 17 and 34 have cafeterias 
nearby 


+ Restrooms 
» Phones 
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Audience and Prereguisites 


» Audience 
+ Developers 
+ Program managers 
+ Others designing .NET class libraries 


» Before you take this course you should have 
the following knowledge and skills: 


+ Working knowledge of the Microsoft ‚NET 
Framework and a .NET language (about 
0.5-1 year) 

+ Objected-oriented (OO) design zer 
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What We Will Cover—Thursday 


[20 JA [Member Types 
= am pesni Inheritance Hierarchies 
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What We Will Cover—Friday 


Lia th OI NENA | 
[After Lunch Wake Up: FxCopDemo | — — | 
Enabling Development Tools 
Security 


ging, Assemblies, and Namespaces 


Lesson 0: Setting the Stage 


. oe successfully completing this lesson, you 
will: 
+ Be exposed to basic terminology 
« Understand the why behind Microsoft WinFX™ 
+ Appreciate your part in the WinFX goals 
+ Recognize the role of guidelines 
» Be aware of the first principles 


+ Know your role in the multi-language 
runtime p 
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Terminology 


» Managed Code: Code where executjon is 
closely managed by the common language 
runtime (CLR) —for example, code produced by 
C# and Microsoft Visual Basic? „NET compilers 


» Unmanaged Code: All other code in the world 

+ ‚NET Libraries: Reusable managed code classes 
that are intended to be used by third-party 
developers (not the output of TLBImp) 

» Applications: Software with which end users 
interact P" 
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The Microsoft Business Model 


Platform 
Advances 


The Microsoft Business Model 


Platform 
Advances 


e 
Applications 


The Microsoft Business Model 


Customer Value! 
j Revenue 


Applications 


The Microsoft Business Model 


More Customer Value 


More Exploitive 
Applications 


Microsoft Platform History 


« Builds o ithe NET Framework 


4 Isa wel -structured programming framework for Microsoft Windows® 


a Continues commitment to backward compatibility E 
p” 
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WinFX "Prime Directive" 


First-class managed 
interfaces to all broadly 
used system technologies 


E 
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About Design Guidelines 


» Often Subjective 
» But benefits of consistency aren't subjective 
+ Contentious by Nature 
+ Intrinsic Value in Conformance 
+ Developers’ knowledge transfers 
» High-level design tools can be built 
+ Time-tested patterns 
» About Conveying Ideas to the Developers 


a 
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About .NET Design Guidelines 


» Easier to Use 
» Raised abstraction level 


» Rapid Application Development (RAD) / component- 
oriented 


» Single API Targets Multiple Users 
» Range of languages: Visual Basic, C#, C++, third-party 
» Range of styles: RAD, systems, etc. 
» Consistent availability of functionality 
» Single platform 
» More headroom 
» Increased complexity for increased control 
« Example: Async IO 


First Principles 


+ What does your library look like to program 
against? 
» Design in reverse: 

» Write the three lines of code the developer 
will have to write, then model the APIs 
around making that possible 

» Example: Console.writeLine() 

» Understand what it is like from other 
languages as well 


Common Language Specification 

(CLS) 

» Ensures components can be accessed from 
any programming language 

» Is fundamentally a compromise between 
languages and component providers 


» Adhering to the CLS broadens your user base 
+ C# does automatic checking 
+ Visual Basic and MC++ (v1) do not check 
[assembly: CLSCompliant(true)] 
A 
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What We Will NOT Cover 


» Introduction to ‚NET or C# 

» Source Code Conventjons 

» Data Structures and Algorithms 

+ Introduction to Object-Oriented Design 


Lesson 0 Summary 


+ WinFX starts a virtuous cycle 


» The WinFX “Prime Directive" is: First-class 
managed interfaces to all broadly used 
system technologies 


+ Guidelines are often contentious but 
valuable 


» The CLS is important and easy to follow 
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